home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / gldrawelements.z / gldrawelements
Encoding:
Text File  |  2002-10-03  |  7.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss - render primitives from array data
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss( GLenum _m_o_d_e,
  14.                           GLsizei _c_o_u_n_t,
  15.                           GLenum _t_y_p_e,
  16.                           const GLvoid *_i_n_d_i_c_e_s )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _m_o_d_e     Specifies what kind of primitives to render.  Symbolic constants
  21.               GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  22.               GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP,
  23.               GGGGLLLL____QQQQUUUUAAAADDDDSSSS, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN are accepted.
  24.  
  25.      _c_o_u_n_t    Specifies the number of elements to be rendered.
  26.  
  27.      _t_y_p_e     Specifies the type of the values in _i_n_d_i_c_e_s. Must be one of
  28.               GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT.
  29.  
  30.      _i_n_d_i_c_e_s  Specifies a pointer to the location where the indices are
  31.               stored.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss specifies multiple geometric primitives with very few
  35.      subroutine calls. Instead of calling a GL function to pass each
  36.      individual vertex, normal, texture coordinate, edge flag, or color, you
  37.      can prespecify separate arrays of vertices, normals, and so on and use
  38.      them to construct a sequence of primitives with a single call to
  39.      ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss.
  40.  
  41.      When ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is called, it uses _c_o_u_n_t sequential elements from an
  42.      enabled array, starting at _i_n_d_i_c_e_s to construct a sequence of geometric
  43.      primitives. _m_o_d_e specifies what kind of primitives are constructed, and
  44.      how the array elements construct these primitives. If more than one array
  45.      is enabled, each is used. If GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY is not enabled, no geometric
  46.      primitives are constructed.
  47.  
  48.      Vertex attributes that are modified by ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss have an unspecified
  49.      value after ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss returns. For example, if GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is
  50.      enabled, the value of the current color is undefined after ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss
  51.      executes. Attributes that aren't modified maintain their previous values.
  52.  
  53. NNNNOOOOTTTTEEEESSSS
  54.      ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is available only if the GL version is 1.1 or greater.
  55.  
  56.      ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is included in display lists. If ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is entered
  57.      into a display list, the necessary array data (determined by the array
  58.      pointers and enables) is also entered into the display list. Because the
  59.      array pointers and enables are client-side state, their values affect
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      display lists when the lists are created, not when the lists are
  75.      executed.
  76.  
  77. EEEERRRRRRRROOOORRRRSSSS
  78.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  79.  
  80.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _c_o_u_n_t is negative.
  81.  
  82.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss is executed between
  83.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding ggggllllEEEEnnnndddd.
  84.  
  85.  
  86. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  87.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss,
  88.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr, ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  89.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.